home *** CD-ROM | disk | FTP | other *** search
/ Speccy ClassiX 1998 / Speccy ClassiX 98.iso / amiga_system / the_aminet / util / boot / req2key.lha / req2key.doc < prev   
Text File  |  1995-10-29  |  6KB  |  139 lines
  1.     req2key 1.0 - control your requesters via keyboard
  2.     ===================================================
  3.  
  4.  
  5. DISTRIBUTION
  6.  
  7.     req2key 1.0 is FREEWARE
  8.  
  9.  
  10. CHANGES
  11.  
  12.     - req2key now can be removed using option quit or remove
  13.     - req2key auto-detaches, no need to run it (stack usage is also reduced ->
  14.       V1.0 doesn't use more memory than V0.9)
  15.     - req2key doesn't crash when started from WB (but it will not install
  16.       itself)
  17.     - now allows you to select one or more keys to cancel requesters (if you
  18.       like)
  19.  
  20.  
  21.  
  22. INTRODUCTION
  23.  
  24.     req2key allows you to control your requesters via (configurable)
  25.     keyboard commands (all the old keyboard and mouse commands work too).
  26.     For example if you type 'req2key cancel "lshift ctrl escape" okay
  27.     "return rshift"', you will be able to cancel your requesters by pressing
  28.     left shift key, control key or escape key, select okay by pressing
  29.     return or right shift key....
  30.  
  31.     req2key's default behavior is (if you start it without arguments):
  32.  
  33.         escape     - cancel your requester, same as LAmiga-B
  34.         return     - select okay, same as LAmiga-V
  35.         f1,f2,..fn - select gadget number 1,2,...,n (from left to right)
  36.                      (these keys can't be changed and will always work while
  37.                      req2key is installed)
  38.  
  39. INSTALLATION
  40.     First of all, req2key needs at least Kickstart V2.0.
  41.  
  42.     Put req2key in your C: directory (or somewhere in your path) and add the
  43.     command 'req2key' (with or without arguments) somewhere in your
  44.     s:user-startup or s:startup-sequence (I start it right after setpatch
  45.     before any trouble and requesters might occur).
  46.  
  47.     The argument template for req2key is 'remove=quit/S, cancel/K, ok=okay/K'
  48.     where the arguments for cancel and okay are strings (specifying the
  49.     keys to select cancel or okay) matching the following template 'space/S,
  50.     ret=return/S, esc=escape/S, del=delete/S, help/S, lshift/S, rshift/S,
  51.     ctrl=control/S, lalt/S, ralt/S, lcommand=lamiga/S, rcommand=ramiga/S':
  52.  
  53.     space               - space bar
  54.     ret or return       - return or enter key
  55.     esc or escape       - escape key
  56.     del                 - delete key
  57.     help                - help key
  58.     lshift              - left shift key
  59.     rshift              - right shift key
  60.     ctrl or control     - control key
  61.     lalt                - left alt key
  62.     ralt                - right alt key
  63.     lcommand or lamiga  - left amiga key
  64.     rcommand or ramiga  - right amiga key
  65.  
  66.  
  67.     NOTE: - if you wan't to specify more than one key for cancel or okay, you have to
  68.             enclose the keys in "" (e.g. 'req2key ok "lshift return"')
  69.  
  70.           - specifying lamiga or lcommand will prevent you from using lamiga-v
  71.             or lamiga-b
  72.  
  73.     If req2key is already installed, and you start it twice (without option 
  74.     quit or remove), you will reset your keyboard commands to those
  75.     specified by the arguments given to req2key.
  76.  
  77.     If req2key is running and you start it again with option quit or
  78.     remove, it will try to remove the patches and deinstall itself. However
  79.     you will get a message telling you if or if not req2key was removed. If
  80.     you use option quit while req2key is not running, nothing will happen.
  81.  
  82.     NOTE: - removing a patch is NEVER 100% safe, so using option quit or
  83.             remove might as well CRASH YOUR MACHINE. If you don't like this,
  84.             try 'req2key cancel "" okay ""' which is a way of disabling
  85.             req2key (guess why ?), but this will not free system resources
  86.             allocated by req2key (also remember the function keys, which are
  87.             not disabled).
  88.  
  89.           - you can't remove req2key, while some requesters are active or if
  90.             another program has patched one or more of the functions patched
  91.             by req2key.
  92.  
  93.  
  94.     req2key CAN be installed while some requesters are active..your machine
  95.     WON'T crash (but you can't use the additional keyboard commands with
  96.     those requesters).
  97.  
  98.     req2key patches 4 functions in intuition. Only requesters which are
  99.     built using EasyRequestArgs and BuildEasyRequestArgs are patched for the
  100.     new keyboard commands...
  101.  
  102.     Hope you understood the above. My english isn't very good (as you might have
  103.     noticed ;) and I HATE writing docs. So here are some ...
  104.  
  105.  
  106. EXAMPLES
  107.  
  108.     command:                           cancel with            select okay with
  109.  
  110.  
  111.     'req2key'                          escape                   return
  112.     'req2key cancel rshift'            right shift              return
  113.     'req2key cancel "lhsift escape"'   left shift or escape     return
  114.     'req2key okay "rshift ret"'        escape                   rigth shift or return
  115.     'req2key ok "rshift ret"           escape                   right shift or return
  116.     'req2key ok "" cancel ""'          none                     none
  117.     'req2key cancel ""'                none                     return
  118.     .                                  .                        .
  119.     .                                  .                        .
  120.     .                                  .                        .
  121.  
  122.  
  123.  
  124. BUGS
  125.     - REMEMBER: using option quit or remove might CRASH your amiga (it NEVER did
  126.       crash my machine). If you use it, just hope (or make sure) that no other
  127.       program is about to open a requester.
  128.     - no real WB support (which I will NEVER add)
  129.     - no sanity checks (you can specify the same keys for cancel and okay)
  130.  
  131.  
  132. AUTHOR
  133.  
  134.     For comments or bug-reports please mail to:
  135.  
  136.         Ralf Schmitt
  137.         schmr000@goofy.zdv.uni-mainz.de
  138.  
  139.